<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta name="Author" content="Stefan Baebler">
   <meta name="GENERATOR" content="Mozilla/4.75 [en] (Windows NT 5.0; U) [Netscape]">
   <title>Makumba whitepaper</title>
   <link rel="stylesheet" type="text/css" media="all" href="main.css">
   <script type="text/javascript" src="main.js"></script>
</head>
<body>
   <script type="text/javascript">
      makeNavBar("");
   </script>

<h1>
Makumba Whitepaper</h1>

<p>The basic idea of Makumba application development is as follows:
<ul>
<li>
the Organisation describes the data in a simple and neutral <a href="makumba-spec.html#Data_Description">Data
Definition</a> language</li>

<li>
a database layer reads the Data Definition and automatically generates
code that represents and processes the data in a database engine. Several
<a href="SQL-drivers.html">SQL
engines</a> are supported for now. Data is fully portable between different
Makumba supported databases. Soon, data will be represented in XML</li>

<li>
a presentation layer reads the Data Definition and automatically generates
a user interface. HTML interface is generated for now, through a JSP taglib</li>

<li>
the webmaster can adjust the default HTML presentation to the lowest detail</li>

<li>
<a href="http://www.odmg.org/">OQL</a> can be used to interrogate the database.
The database layer uses the data definition to translate the OQL into the
host SQL and provides the data in the format required by the data definition.</li>

<li>
the programmer can add "organisational logic" between the interface and
the database depending on the organisation's needs</li>
</ul>

<center><img SRC="architecture.gif" height="433" width="624" alt="Architecture scheme"></center>

<p><b>The following are high priorities of Makumba:</b>
<ul>
<li>
phased development (easy to start an application in order to collect data,
and to adjust it later on when further processing is needed)</li>

<li>
simplicity (a minimum necessary number of features, small code, easy to
maintain)</li>

<li>
distributed development (people developing at different locations at different
times)</li>

<li>
collaboration between programmers and webmasters, allowing them to put
their skill and inclination to full use and not do jobs that are too boring
or too difficult for them</li>

<li>
ability to finely adjust HTML interface</li>

<li>
platform and database engine independence</li>

<li>
data compatibility (for copying and replication) across multiple databases</li>
</ul>

<b>The following are _not_ high priorities of Makumba, but can be addressed
later:</b>
<ul>
<li>
speed (most current database drivers are the minimum necessary, but they
can be optimized using stored procedures and engine-specific features)</li>

<li>
multiple features for complex needs</li>
</ul>

<b>Why didn't BEST use JSP, Lasso LDML, Cold Fusion CFML, etc?</b>
<br>We have looked at the mentioned technologies and found several problems,
that we try to solve in Makumba
<ul>
<li>
they are commercial (<a href="makumba.html#CFML">CFML</a>, <a href="makumba.html#Lasso">LDML</a>)</li>

<li>
they don't put data definitions to full use in order to generate default
interfaces during rapid application development</li>

<li>
their SQL queries are SQL engine dependent, making applications not portable
across SQL engines</li>
</ul>

<b>BEST developed Makumba out of the following needs:</b>
<ul>
<li>
they need a simple technology to base all the applications on. <a href="http://www.BEST.eu.org">BEST</a>
had several legacy applications built with different technologies (Java,
Lotus Notes), with different data formats, that needed to communicate better</li>

<li>
distributed development: BEST developers are not co-located, and meet rarely</li>

<li>
multiple platforms and database engines: a typical developer would use
Windows and ODBC or MySQL databases. The developed software runs on Unix
(Solaris or Linux) with Postgresql</li>

<li>
multiple member inclinations: programmers don't like to do web pages, so
the simple interface that they generate with Makumba can later be adjusted
by people who like to write web content</li>

<li>
need for small number of features that can be learned by members in a short
time. BEST students only stay 3 years on the average in the organisation</li>

<li>
applications need to be started up fast and adjusted later on, when specialised
people are available for programming work. In the meantime, data can be
gathered.</li>

<li>
they already had experience with websites generated by Java servers: Java
CGIs, servlets, <a href="http://best.nada.kth.se:8080/jml/jml.cgi/index.jml">JML</a>
(a technology they invented in 1996, similar to nowadays JSP, etc</li>

<li>
they found Lotus Notes programming much too heavy, with lots of unneeded
features, hard to learn and its visual programming model was unsuited for
distributed development.</li>

<li>
the Notes databases didn't intercommunicate sufficiently due to the specialisation
need to achieve such communication</li>

<li>
Lotus Notes web content adjustment possibilities were low comparing to
the HTML-oriented solutions like <a href="http://best.nada.kth.se:8080/jml/jml.cgi/index.jml">JML</a>
and JSP</li>
</ul>

<script type="text/javascript">
   makeFooter("$Id$");
</script>
</body>
</html>
